home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / comm / vzbeta12.zip / VZ.DOC < prev    next >
Text File  |  1992-07-17  |  21KB  |  442 lines
  1.  
  2.                              Visual Zmodem
  3.                  High-Quality External Protocol Driver
  4.                  Copyright (C) 1992, by Jon R. Rickher
  5.                           All Rights Reserved
  6.  
  7.                               DESCRIPTION
  8.                              =============
  9.  
  10. Visual Zmodem is not merely a Zmodem driver. It also supports Xmodem CRC,
  11. Xmodem Checksum, Xmodem 1K, Xmodem 1kG, Ymodem, Ymodem 1kG, and Kermit, as
  12. well as Zmodem and ZmodemSprint (Zmodem with 8k blocks).
  13.  
  14. VZ is mostly compatible with Omen Technology's DSZ, but looks better and
  15. does a few things (WWIV-status monitoring, Kermit, ZIP commenting or un-
  16. commenting, and virus scanning [with MacAfee's SCAN.EXE]) that neither DSZ nor
  17. GSZ support.
  18.  
  19. VZ is meant to provide BBS systems or communications programs without ZModem
  20. or Kermit with those options, and to provide all BBS systems and
  21. communications with a better-looking display during transfers, while using
  22. memory economically. In addition, using VZ when downloading files should
  23. help prevent the spread of viruses; since it's all automatic, you don't
  24. have to worry about putting off your virus-scanning and then later forgetting
  25. to do it at all and thereby letting a virus slip through the cracks.
  26.  
  27.  
  28.  
  29.                        USE WITH WWIVNET SOFTWARE
  30.                       ===========================
  31.  
  32. Right now it is possible to use VZ with the WWIVnet software by renaming it
  33. to DSZ.EXE and making sure you have 120k free RAM for network callouts. In
  34. the future (in the next release of the WWIVnet software) VZ will be directly
  35. supported and will not need to be renamed.
  36.  
  37.  
  38.                           ZIP (UN)COMMENTING
  39.                          ====================
  40.  
  41. Zip Commenting is enabled with the -a option. If the received file is a valid
  42. ZIP file, and a file called VZ.CMT exists in the current directory, then
  43. this will be used for the ZIP comment. If no such file exists then any ZIP
  44. comment will be automatically stripped.
  45.  
  46.  
  47.                         AUTOMATIC VIRUS SCANNING
  48.                        ==========================
  49.  
  50. To use the virus-scanning on received files, SCAN.EXE must be in your path.
  51. In addition, for each archive type you wish to be automatically extracted
  52. and scanned, you will need to have in your path the appropriate archive
  53. extractor. VZ looks for the following:
  54.  
  55.                     Archive     VZ will look for
  56.                     -------     ----------------
  57.                       ZIP       PKUNZIP.EXE
  58.                       ARC       PKXARC.COM
  59.                       ARJ       ARJ.EXE
  60.                       LZH       LHA.EXE
  61.                       PAK       PAK.EXE
  62.  
  63. All other files will be scanned as a single file with no extraction if the
  64. file's extension does not match one of the above. Of course, the -v option
  65. must be used. VZ maintains a file called VZSCAN.LOG that shows the results
  66. of the scanning. If a virus is detected there will be an alarm, and the file
  67. will be deleted.
  68.  
  69.                          SYSTEM REQUIREMENTS
  70.                         =====================
  71.  
  72. Visual Zmodem should work on any IBM or IBM compatible computer with a serial
  73. port, including IBM PS/2's, that has at least 256K of memory and a Hercules
  74. or CGA monitor or better. VZ works best on '286-class machines or better that
  75. have at least 512k of expanded memory.
  76.  
  77. Memory requirements vary somewhat. If you do not enable ZmodemSprint then
  78. VZ requires about 120K of memory. Enabling ZmodemSprint adds another 32k
  79. to the memory requirment. Enabling the virus-scanning boosts the memory
  80. requirement more than anything, because the new PKUNZIP itself requires
  81. 185k of memory. Both VZ and PKUNZIP make use of expanded memory (EMS) and
  82. will run better on machines equipped with it.
  83.  
  84.  
  85.                                REGISTRATION
  86.                               ==============
  87.  
  88. VZ is not public domain. It is ShareWare. The evaluation period is one month.
  89. If you find that you are using it after one month has gone by then you are
  90. obligated to delete all but the original archive that contained VZ, or
  91. register it. Registration is a measely $10. If your integrity isn't worth
  92. $10...well, most peoples' integrity *is* worth more than that and I hope
  93. you're one of them. Using VZ without registering also does damage to the
  94. ShareWare concept in general, so please don't abuse or in the end everyone
  95. ends up losing. Really, with this low of a price, there's no excuse for
  96. not registering.
  97.  
  98. VZ may be distributed freely, so long as it is distributed only in its
  99. original archive and so long as this archive is left unmodified. If you
  100. charge a fee for handling costs (disk, whatever), then this fee may be no
  101. more than $5 for a disk containg VZ.
  102.  
  103. Registrations may be mailed to:
  104.  
  105.    Jon R. Rickher
  106.    c/o The Fellowship
  107.    7035 Ethel
  108.    St. Louis, MO 63117
  109.  
  110. This does *not* get a disk mailed to you. Rather, this will give you access
  111. to the latest registered VZ files when you get an account on The Fellowship.
  112. The phone number for The Fellowship is 314-644-5777. If you wish a disk mailed
  113. to you then include an extra $5 (a total of $15). This includes international
  114. orders. This $5 only gets you *one* mailing, however. Additional upgrades
  115. for registered users may be downloaded or you may send another $5 along with
  116. name and registration number for an additional mailing.
  117.  
  118. Note that I do *not* intend to have a zillion different releases coming out
  119. with a new one every four days. I will only release new versions that are
  120. *significantly* changed and improved.
  121.  
  122.  
  123.                             THE DISPLAY WINDOWS
  124.                            =====================
  125.  
  126. The display is easy to understand - there is one window for the current file
  127. being transferred. When sending file(s), if the protocol supports batch
  128. transfers, there is also a batch status window. If you use the -w option
  129. (see below) then there will also be a WWIV status window if CHAIN.TXT is in
  130. the current directory. You may toggle from active window to another window
  131. (making it the "active" window) with the TAB or SHIFT-TAB keys. Windows may
  132. be moved around with the cursor keys (although no window may be moved off
  133. the screen). Windows may be tiled and may overlap. For performance reasons
  134. (it takes time to do some of the windowing), it is best to leave the File
  135. Status window the active window, but you can play around.
  136.  
  137.  
  138.                       PARAMETER DESCRIPTIONS, DETAILED
  139.                      ==================================
  140.  
  141. Running VZ.EXE from a DOS prompt with no parameters shows a simple summary of
  142. available options. These are detailed as follows:
  143.  
  144.    --------------------------------------------------------------------------
  145.  
  146.    port <portnum>        Use serial communications port number <portnum>
  147.  
  148.    Example               VZ port 3 sz *.*
  149.    Default               port 1
  150.    Note                  Only the standard base addresses are supported at
  151.                            this time. PS/2's use different addresses than
  152.                            "normal" computers. The -2 option (see below)
  153.                            can compensate for computers that are inaccurately
  154.                            reported as being PS/2 machines.
  155.  
  156.    --------------------------------------------------------------------------
  157.  
  158.    portx base,IRQ        Specify a new base address and IRQ number for the
  159.                            port defined by the "port portnum" parameter.
  160.  
  161.    Example               vz port 2 portx $2e8,3 sz *.*
  162.    Default               N/A (uses "standard" base addresses and IRQ's for
  163.                            com ports - almost always works)
  164.    Note                  This parameter sequence is only necessary if your
  165.                            serial port is set to use a nonstandard base
  166.                            address and/or IRQ.
  167.  
  168.    --------------------------------------------------------------------------
  169.  
  170.    speed <bpsrate>       Use <bpsrate> when communicating with the chosen
  171.                            serial port
  172.  
  173.    Example               VZ speed 2400 sz *.*
  174.    Default               Whatever speed the computer is currently using to
  175.                            communicate with the chosen serial port.
  176.    Note                  This option is very rarely necessary. Unless you're
  177.                            *sure* you need to change the BPS rate from its
  178.                            current status, it is best to omit this option.
  179.  
  180.    --------------------------------------------------------------------------
  181.  
  182.    restrict              Disallows pathnames, and any filename containing
  183.                            a "/" or "\".
  184.  
  185.    Example               VZ restrict rz
  186.    Default               Off
  187.    Note                  This option is rarely needed.
  188.  
  189.    --------------------------------------------------------------------------
  190.  
  191.    est <speed>           Estimate transfer efficiency based on a modem-to-
  192.                            modem speed of <speed>.
  193.  
  194.    Example               VZ est 9600 sz *.PAS
  195.    Default               Estimate based on DTE-DCE speed (speed with which
  196.                            the computer is communicating with the serial
  197.                            port).
  198.    Note                  If you have the serial port "locked" then this
  199.                            option is useful for reporting transfer efficiency
  200.                            accurately. To maintain DSZ commandline-
  201.                            compatiblility if the <speed> parameter is 0, then
  202.                            VZ will look ahead one extra parameter.
  203.  
  204.    --------------------------------------------------------------------------
  205.  
  206.    -a                    Toggles ZIPfile (un)commenting.
  207.  
  208.    Example               VZ port 4 -a rz C:\DLOADS
  209.    Default               Off
  210.    Note                  If a file called VZ.CMT exists in the current
  211.                            directory then this will be used for the ZIP
  212.                            comment if this option is enabled. If this
  213.                            option is enabled and no such file exists then
  214.                            ZIP comments will be stripped from incoming
  215.                            files. Very handy for BBSes that do not desire
  216.                            ZIP comments or wish to have a ZIP comment of
  217.                            their own. Registered version only.
  218.  
  219.    --------------------------------------------------------------------------
  220.  
  221.    -d                    Toggles carrier detect monitoring on/off.
  222.  
  223.    Example               VZ -d sz *.*
  224.    Default               On
  225.    Note                  Some modems improperly report their carrier detect
  226.                            status. This option will toggle the automatic
  227.                            carrier detect checking and may be useful when
  228.                            using such modems.
  229.  
  230.    --------------------------------------------------------------------------
  231.  
  232.    -e                    Toggles exploding windows on/off.
  233.  
  234.    Example               VZ -e port 2 sz *.TXT
  235.    Default               Off
  236.  
  237.    --------------------------------------------------------------------------
  238.  
  239.    -f                    Toggles 16550A[FN] UART buffering.
  240.  
  241.    Example               VZ -f port 1 est 2400 rz
  242.    Default               On
  243.    Note                  The UART type is autodetected by default and the
  244.                            16550 UART is used with a trigger level of 14.
  245.  
  246.    --------------------------------------------------------------------------
  247.  
  248.    -n                    Toggles on or off only writing newer files.
  249.  
  250.    Example               VZ -n port 4 rz
  251.    Default               On
  252.    Note                  If this option is on (default) then only newer
  253.                            files with the same name will be written.
  254.  
  255.    --------------------------------------------------------------------------
  256.  
  257.    -r                    Toggles on or off Zmodem crash recovery (resume).
  258.  
  259.    Example               VZ -r rz *.PAS
  260.    Default               On
  261.    Note                  This allows an interrupted file transfer to be
  262.                            resumed after an interruption.
  263.  
  264.    --------------------------------------------------------------------------
  265.  
  266.    -s                    Toggles on or off "squeaky" windows.
  267.  
  268.    Example               VZ -s port 2 sz *.ZIP
  269.    Default               Off
  270.    Note                  This option causes a sound when windows are opened
  271.                             or closed. An aesthetic thing only.
  272.  
  273.    --------------------------------------------------------------------------
  274.  
  275.    -v                    Toggles on or off automatic virus-scanning.
  276.  
  277.    Example               VZ port 2 -v rz
  278.    Default               Off
  279.    Note                  Only the registered version has this option. A status
  280.                            log called VZSCAN.LOG is kept (in the current
  281.                            directory) that shows which files were scanned and
  282.                            which contained viruses or were "clean". Infected
  283.                            files are deleted if this option is toggled on.
  284.                            MacAfee's SCAN.EXE must be in the current directory
  285.                            or exist on your PATH for this option to function.
  286.  
  287.    --------------------------------------------------------------------------
  288.  
  289.    -w                    Toggles on or off WWIV status viewing.
  290.  
  291.    Example               VZ -w port 2 rz
  292.    Default               Off
  293.    Note                  This option, when enabled, causes VZ to look in the
  294.                             current directory for a file called CHAIN.TXT.
  295.                             If this file exists then it is read and some
  296.                             information about the current user is shown on
  297.                             the screen, and that user's time left online is
  298.                             tracked by VZ. If it expires then any transfer is
  299.                             aborted. This can prevent bad line conditions
  300.                             from causing a caller to "hog" the line for
  301.                             excessive amounts of time.
  302.  
  303.    --------------------------------------------------------------------------
  304.  
  305.    -2                    Toggles on or off automatic PS/2 detection.
  306.  
  307.    Example               VZ -2 rz
  308.    Default               On
  309.    Note                  The default (on) will always properly detect if
  310.                            VZ is running on a PS/2 machine (and all base
  311.                            addresses and IRQ numbers will be adjusted
  312.                            accordingly). However, some standard AT machines
  313.                            improperly report themselves as PS/2's, which
  314.                            could cause a port address or IRQ conflict. If
  315.                            this is a problem, then this option will solve it.
  316.  
  317.    --------------------------------------------------------------------------
  318.  
  319.    -8                    Toggles on or off ZmodemSprint.
  320.  
  321.    Example               VZ -8 sz *.ARJ
  322.    Default               Off
  323.    Note                  This option can increase overall throughput by
  324.                            using 8k blocks with Zmodem transfers. Although
  325.                            this is not part of the defined Zmodem standard,
  326.                            some other Zmodem implementations do support
  327.                            large-block Zmodem transfers, so it is supported
  328.                            here as well. Do not use this option, though,
  329.                            unless you are sure the other side can handle
  330.                            it, or there will be errors. Registered version
  331.                            only.
  332.  
  333.    --------------------------------------------------------------------------
  334.  
  335.    on                    Use CTS/RTS flow control
  336.  
  337.    Example               VZ on sz *.zip
  338.    Default               CTS/RTS is enabled by default if the connect speed
  339.                            is greater than 2400 bps, otherwise XON/XOFF
  340.                            is enabled.
  341.  
  342.    --------------------------------------------------------------------------
  343.  
  344.    off                   Turn off all flow control
  345.  
  346.    Example               VZ off rz
  347.    Default               Flow control is XON/XOFF for connect rates of 2400
  348.                            or slower or CTS/RTS if the connect rate is
  349.                            higher by default. This option overrides the
  350.                            defaults and turns off all flow control.
  351.  
  352.    --------------------------------------------------------------------------
  353.  
  354.    both                  Turn on XON/XOFF and CTS/RTS flow control
  355.  
  356.    Example               VZ both sz *.pak
  357.    Default               See description for "off".
  358.  
  359.    --------------------------------------------------------------------------
  360.  
  361.    slow                  Use CTS/RTS flow control but lower the RTS signal
  362.                            during disk access. This should allow systems with
  363.                            unusually slow hard drives or floppy drives,
  364.                            or systems multitasking heavily, to eradicate
  365.                            some or all data input errors during a transfer.
  366.  
  367.    --------------------------------------------------------------------------
  368.    Transferring Files, Protocol and Direction Selection:
  369.  
  370.    sz             Send Zmodem
  371.    rz             Receive Zmodem
  372.  
  373.    sb             Send Ymodem
  374.    rb             Receive Ymodem
  375.  
  376.    sx             Send Xmodem
  377.    rx             Receive Xmodem
  378.  
  379.    sb -g          Send Ymodem 1kG
  380.    rb -g          Receive Ymodem 1kG
  381.  
  382.    sx -k          Send Xmodem 1k
  383.    rx -k          Receive Xmodem 1k
  384.  
  385.    sx -g          Send Xmodem 1kG
  386.    rx -g          Receive Xmodem 1kG
  387.  
  388.    --------------------------------------------------------------------------
  389.  
  390.    Transferring Files, Filename Selection:
  391.  
  392.    The last parameter of the commandline should be either a filemask (eg,
  393.    "C:\*.*" or a filename or (if you're receiving, and the protocol
  394.    allows it [Ymodem, Kermit, Zmodem]) no filemask or filename at all.
  395.  
  396.    In addition, when receiving you may simply specify a directory and
  397.    all transferred files will be placed there.
  398.  
  399.    For protocols that support batch transfers you may also specify a file
  400.    list if you precede the name of the file list with the "@" symbol (eg,
  401.    "VZ port 3 -es sz @C:\DLOADS\FILES.LST"). Any files listed in this
  402.    listfile, if they exist, will be sent. Note that files in this list
  403.    must not contain DOS wildcards.
  404.  
  405.    --------------------------------------------------------------------------
  406.  
  407.    Example complex send commandline:
  408.  
  409.    VZ port 2 est 9600 -waves28 sz @C:\WWIV\FILES.DL
  410.  
  411.    This commandline would use port 2 with the standard base address and IRQ
  412.    for a non-PS/2 system, estimating transfer times based on a 9600 bps speed,
  413.    with WWIV status, exploding windows, "squeaky" windows, no PS/2 detection,
  414.    and 8K Zmodem blocks - sending all files that actually exist that are
  415.    listed in the file C:\WWIV\FILES.DL. If a file called VZ.CMT exists in
  416.    the current directory, this would be used as a zip comment for received
  417.    files, else zip comments would be stripped from incoming ZIP files. All
  418.    received files (if this were a receive commandline) would also be scanned
  419.    for viruses using MacAfee's SCAN.EXE utility and infected files would
  420.    be deleted.
  421.  
  422.    --------------------------------------------------------------------------
  423.  
  424.    Included batch files:
  425.  
  426.    Name             Description
  427.    -------------    ---------------------------------------------------------
  428.    VZS.BAT          Standard batch file for using VZ within Telix, sending
  429.    VZR.BAT          Standard batch file for using VZ within Telix, receiving
  430.    VZS8.BAT         Batch file for using VZ with 8k Zmodem within Telix,
  431.                       sending
  432.    VZR8.BAT         Batch file for using VZ with 8k Zmodem within Telix,
  433.                       receiving
  434.  
  435.    Edit the batch files to reflect your communications port. You can also
  436.    specify a download directory for the receive batch files, and disable
  437.    the virus-scanning, zip-commenting, exploding windows, and squeaky windows
  438.    by removing the appropriate option.
  439.  
  440.    --------------------------------------------------------------------------
  441.  
  442.